home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio / Ham Radio CD-ROM (Emerald Software) (1995).ISO / misc / showlog / showlog.doc < prev    next >
Encoding:
Text File  |  1991-04-28  |  7.5 KB  |  189 lines
  1.  
  2.                               SHOWLOG Program
  3.  
  4.                                   V1.0
  5.  
  6. This program will show on screen graphic analysis of the automatic
  7. files that Microsats create, such as:
  8.  
  9.         ELTLOGXX   Records single and double bit memory errors
  10.                    This file is cumulative as many days can be
  11.                    recorded in this file. It is usually the same
  12.                    file number, that grows recording new errors.
  13.  
  14.         AL91xxyy   Recording stations and Microsat activity
  15.                    This file is created one per day, having
  16.                    on xxyy Month and Day of the log.
  17.  
  18.  
  19.  
  20. WHAT IS NEEDED:
  21.  
  22. Program had been tested on a PC-XT with CGA (Color Graphics Adapter)
  23.  
  24. You need to download one of the mentioned files, that will be used as input
  25. for the program. After download, use PHS to extract it. I.E.
  26.  
  27.                          PHS 301.dl /x
  28.  
  29. You will have after extracting a file either ELTLOGXX.n or AL91xxyy.
  30.  
  31. This file is input to this program.
  32.  
  33. You will also need a recent Keplerian data file in AMSAT format such as:
  34. (numeric data should be on the shown positions, alphabetic data
  35. should be equal to this example)
  36.  
  37. Satellite: LO-19
  38. Catalog number: 20442
  39. Epoch time:      91043.71839123              Don't worry if there
  40. Element set:     196                         are many satellites on
  41. Inclination:       98.6819 deg               the file, or if there is
  42. RA of node:       124.2620 deg               additional information
  43. Eccentricity:    0.0012688                   as program will use,
  44. Arg of perigee:   167.7080 deg               search and get only
  45. Mean anomaly:     192.4398 deg               required data.
  46. Mean motion:   14.29196610 rev/day
  47. Decay rate:      .00000765 rev/day^2
  48. Epoch rev:            5522
  49.  
  50. Program will read this ASCII file, search for the satellite needed, and
  51. extract keplerian data to calculate satellite position according to recorded
  52. time found in the logs.
  53.  
  54. A earth map, that's contained on SHOWLOG.MAP, included in this package.
  55.  
  56. GRAPHICS.COM, a module included in DOS, that will allow you to print
  57. whatever picture this program produces.
  58.  
  59.  
  60. ----------------------------------------------------------------------------
  61.  
  62. ERROR LOG ANALYSIS DISPLAY
  63.  
  64. When you select an ELTLOG for process, program will mark on the map,
  65. where the hit that caused memory error was produced.
  66.  
  67. If the error was a single bit, then a cross will be marked, if
  68. double bit then a square will be marked.
  69.  
  70. On the lower right of the screen, you will see the count of Single error and
  71. Double error, both separated by a slash (/).
  72.  
  73. Also the memory address and the file (if applicable) are shown.
  74.  
  75. Display will constantly show start date/time and actual date/time of the
  76. plotted error.
  77.  
  78. On the lower left of the screen a bar graph will be shown, every vertical
  79. bar representing one day, being its highness according to the amount of
  80. errors, that could be measured along the scale shown.
  81.  
  82. If the error was a double bit, then you will see a hole on the vertical bar.
  83.  
  84. When complete log had been read, a file with the name EL91xxyy.PIC will
  85. be written on disk. This file is a copy of the screen, and can be
  86. viewed with the program using the DISPLAY selection.
  87.  
  88. If you load GRAPHICS.COM before running this program, you can print
  89. a copy of the screen pressing Shift-PrintScreen.
  90.  
  91. This chart can be used to track where memory errors are produced, there
  92. is a known geomagnetic perturbation known as 'South Atlantic Anomaly',
  93. that will easily be seen when running this program.
  94.  
  95. You will see also that over populated areas, or areas where the satellite
  96. gets more users, there is also a tendency to show memory errors.
  97.  
  98. The daily error graph can be used to track solar magnetic storms, or other
  99. external/internal influences that shows over time. Will be interesting to
  100. correlate this graph to the solar activity to see if there is any
  101. correspondence.
  102.  
  103. Graphs over periods of time could be useful to track overall activity
  104. of the Microsats and tendencies if there are any.
  105.  
  106.  
  107. -----------------------------------------------------------------------------
  108.  
  109.  
  110. ACTIVITY LOG DISPLAY
  111.  
  112. When you input to the program an Activity Log, the show Starts.
  113.  
  114. I will like to express my appreciation and recognition to the gurus
  115. that make the programs that runs on the Microsats, through this program
  116. you can see what a lot of things these boxes can handle simultaneously.
  117.  
  118. When SHOWLOG analyzes an Activity Log, you will see on the lower right
  119. of the screen the Satellite, AL file under analysis, Date/time, Current
  120. Session and Amount of free memory the satellite has.
  121.  
  122. On the map, SHOWLOG will place a thin mark where one user connects, if there
  123. are two users then a double wide mark will be placed, if three users then
  124. the satellite path will be more wide, and so on.
  125.  
  126. So you will see in the map where the satellite gets activity, and by the
  127. wideness of its path the amount of users in that area.
  128.  
  129. On the lower part of the screen you will see the Call Sign that gets
  130. a connection, as well as its SSID (usually -0).
  131.  
  132. Also is shown which uplink channel the user is using. Either ^A, ^B, ^C or ^D
  133. These channels corresponds to the uplink frequencies, 145,900, 920, 940 & 960
  134. for the Pacsat or 145,840, 860, 880, 900 for the LUSAT.
  135.  
  136. Below the user Callsign, you will see which activity is performed, either
  137. DIRs, Downloads, Uploads, etc.
  138.  
  139. When Downloads or uploads are requested, the program shows which file
  140. had been requested and from which position on that file.
  141. For example D 64E:12432 is saying that file 64E was requested and is
  142. being requested from its position 12432 and on. Same for uploads.
  143.  
  144. There are four maximum users. When an user LOGs OFF (Disconnect), its
  145. display remains until this Task is being needed for other user.
  146.  
  147. A fifth user is the Microsat itself, that could be doing internal functions,
  148. such as deleting a file, checking memory, Start/Stop Tasks, etc.
  149.  
  150. This is shown on a fifth column, when it appears REJECT on this column it is
  151. due all tasks are in use and another user had requested connection.
  152.  
  153. Also broadcast requests are being handled by the Microsat, and as such
  154. are being shown on this column, as well as the user that requested the
  155. broadcast and on which channel uplinked the request.
  156.  
  157. When Activity log analysis finishes, program will give a report on
  158. every activity requested to the Satellite, and amount of times requested.
  159.  
  160. After this screen, if you press enter, you will see a report containing  all
  161. Callsigns (First 77 only, due lack of screen space), that contacted or
  162. broadcasted the Microsat during the Activity log day. The number shown for each
  163. callsign is the amount of LOGON plus Broadcast requests made by that station.
  164.  
  165. It the station made a Broadcast, it will be marked with a tiny point close
  166. to the number on that Callsign number of Logons.
  167.  
  168. Program will create an AL91xxyy.PIC containing map and BBS statistics and
  169. a file AU91xxyy.PIC containing map and users Callsigns.
  170.  
  171. You can print either report pressing Alt-PrtSc.
  172.  
  173. You can append several ALOG files for a continued activity show if required.
  174.  
  175. Program can be slowed pressing -/+ Keys. Speed will be marked accordingly.
  176. Maximum speed is 10.
  177.  
  178. If you like fancy noises, then press Y and will hear the Microsat Symphony.
  179.  
  180. When seen, your call will be rewarded with a special sound
  181. by the Microsat SHOWLOG.
  182.  
  183.  
  184. Any suggestions, critics or insults are welcome.
  185.  
  186. ENJOY!
  187.  
  188. Best 73s, LU7ABF, Pedro Converso.  AMSAT Argentina Member.
  189.